Contexto global

FindFiles

Sintaxis:

FindFiles(<Ruta>, <Máscara>, <BuscarEnSubdirectorios>)

Parámetros:

Tipo: Cadena.
Ruta del directorio a buscar. El directorio puede estar en una red local o en un servidor FTP. Con estos esquemas, debe usar una barra diagonal ‘/’ y no una barra invertida ‘\’.
Se supone la instrucción de un nombre completo de archivo (ruta + nombre).

Tipo: Cadena.
Una máscara de selección de archivos.
Si se especifica este parámetro, el primer parámetro se trata como una ruta al directorio donde se buscarán los archivos que coincidan con la máscara.
Para Microsoft Windows:
La máscara puede incluir los siguientes caracteres comodín: * (cualquier número de cualquier carácter) y ? (cualquier carácter).
Ejemplos:

Para Linux, macOS, iOS y Android:
La máscara puede incluir los siguientes caracteres y comodines:

• Cualquier carácter permitido en los nombres de archivo:
  • Para Linux, macOS – sensible a mayúsculas y minúsculas
  • Para iOS y Android – no sensible a mayúsculas y minúsculas
• * (cualquier número de cualquier carácter)
• ? (cualquier carácter)
• [ (una clase de caracteres). Especifique una secuencia de caracteres después del corchete de apertura. Cualquiera de estos caracteres coincide con el filtro. Puede especificar un rango de caracteres usando un guión (-). Un corchete de cierre (]) designa el final de la clase de caracteres. Para incluir un guión en el conjunto de caracteres, especifíquelo en la primera o última posición. Un signo de exclamación (!) después del corchete de apertura especifica que todos los caracteres excepto los enumerados coinciden con el filtro.

Ejemplo:

Tipo: Booleano.
Verdadero – búsqueda en directorios anidados en el parámetro <Ruta>.
El parámetro se ignora si no se especifica el parámetro <Máscara>, porque se supone que se está buscando un solo archivo.
Valor predeterminado: Falso.

Valor devuelto:

Tipo: Array.
Array de valores de tipo Archivo, que contiene los archivos encontrados.

Descripción:

Busca archivos y directorios según una máscara dada, ubicados en un directorio dado.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, servidor, cliente grueso, conexión externa, aplicación móvil (cliente), aplicación móvil (servidor), servidor independiente móvil.

Nota:

Todos los objetos de búsqueda deben estar ubicados en un solo directorio.
Para utilizar el método en el cliente web, debe adjuntar previamente la extensión para trabajar con archivos.

Ejemplo:

Consulte también:

Contexto global, método BeginFindingFiles
Contexto global, método FindFilesAsync

Disponible desde:

Disponible desde la versión 8.0.

Descripción cambiada en la versión 8.3.18.